---
title: 실험적 클라이언트 사전 렌더링
sidebar:
  label: 클라이언트 사전 렌더링
i18nReady: true
---

import Since from '~/components/Since.astro'

<p>

**타입:** `boolean`<br />
**기본값:** `false`<br />
<Since v="4.2.0" />
</p>

지원되는 브라우저의 클라이언트에서 미리 가져온 페이지를 사전 렌더링할 수 있습니다.

이 기능은 실험적인 [Speculation Rules Web API](https://developer.mozilla.org/en-US/docs/Web/API/Speculation_Rules_API)를 사용하며 전역적으로 기본 `prefetch` 동작을 향상시켜 클라이언트에서 링크를 사전 렌더링합니다.
이 기능을 활성화하기 전에 [클라이언트에서 사전 렌더링할 때의 잠재적 위험](https://developer.mozilla.org/en-US/docs/Web/API/Speculation_Rules_API#unsafe_prefetching)을 검토하는 것이 좋습니다.

`astro.config.mjs`에서 원하는 `prefetch` 구성 옵션과 함께 클라이언트 측 사전 렌더링을 활성화하세요:

```js
// astro.config.mjs
{
  prefetch: {
    prefetchAll: true,
    defaultStrategy: 'viewport',
  },
	experimental: {
		clientPrerender: true,
	},
}
```

사이트의 모든 `<a />` 링크에서 `data-astro-prefetch` 속성을 계속 사용하여 프리페칭을 설정하세요.
문서의 head에 `<link>` 태그를 추가하거나 JavaScript로 페이지를 가져오는 대신, 해당하는 추측 규칙이 포함된 `<script>` 태그가 추가됩니다.

클라이언트 측 사전 렌더링에는 브라우저 지원이 필요합니다. Speculation Rules API가 지원되지 않는 경우, `prefetch`는 지원되는 전략으로 대체됩니다.

더 많은 `prefetch` 옵션과 사용법은 [프리페치 가이드](/ko/guides/prefetch/)를 참조하세요.
